home *** CD-ROM | disk | FTP | other *** search
/ Dream 55 / Amiga_Dream_55.iso / RISCOS / APPS / TEXT / PS / KIT-PS.ZIP / Kit PS / !EPSobject / Docs / Manual < prev    next >
Text File  |  1993-06-10  |  10KB  |  266 lines
  1.  
  2.  
  3.                                EPSObject v.3.00
  4.                                ================
  5.                                
  6.                                    from:
  7.  
  8.                                Willi Langhans
  9.  
  10.  
  11.         !!! Please also read the additional notes in the 'Update' file(s) !!!
  12.         ---------------------------------------------------------------------
  13.  
  14. Introduction
  15. ============
  16.  
  17. '!EPSObject' allows you to convert vector graphic files, previously stored in
  18. Adobe Illustrated EPS format, into vector objects suitable for use in !Draw
  19. on the Acorn Archimedes.
  20.  
  21. In it's present form '!EPSObject' converts only 'fixed format' AI files.
  22. However, export via this format is supported by various PC/Mac programs
  23. including :
  24.   
  25.   CorelDraw 2.xx
  26.   CorelDraw 3.xx
  27.   Aldus FreeHand
  28.   Professional Draw
  29.   Adobe Illustrator
  30.   TypeAlign
  31.  
  32.  
  33. Other programs may be capable of producing EPS files which also convert successfully
  34. but this is largely a matter of trial and error. Please let me know if you discover
  35. programs (other than those listed above) using a compatible format.
  36.  
  37. Besides examples from the above programs, there is much clip-art available
  38. in EPS format from various sources. Likewise, I would like to hear of any sources
  39. of Public Domain EPS files you may discover.
  40.  
  41. NB. !Artworks files exported in Illustrator 88, CorelDraw 2.0 or CorelDraw 3.0
  42. format should also convert quite happily.
  43.  
  44. EPS files of bit-image graphics are NOT supported, nor ever likely to be!!
  45.  
  46. ---
  47.  
  48. What's Changed?
  49. ===============
  50.  
  51. Improvements over previous versions include:
  52.   
  53.   Handling of Text objects (with some limitations).
  54.   Grouping of Objects.
  55.   Correct handling of Line types.
  56.   Improved colour rendering and shading.
  57.   
  58. One major improvement is that it is no longer neccessary to 'doctor' the
  59. EPS source files as in older versions. In fact it is advisable not too as
  60. use is now made of some previously 'neglected' information.
  61.  
  62. Earlier versions of '!EPSObject' required removal of great chunks of Header
  63. information and castration of the Screen display Image block appended
  64. to the end of most EPS files. The latter (ignored by '!EPSObject') is only useful
  65. for PCs and Macs but can generally be displayed on an Archimedes after using
  66. a suitable image convertor program (eg. !Translator from John Kortink).
  67. The format is usually (but not always) TIFF. You can then compare the
  68. resulting bit-image file with the final converted Draw file (although THERE
  69. IS NO REAL COMPARISON).
  70.  
  71. ---
  72.  
  73. Why !EPSobject?
  74. ==============
  75.  
  76. Despite being a little slower, the advantages over using !Artworks for conversion
  77. of EPS files should not be neglected.
  78.  
  79. eg.
  80.  
  81. !Artworks is expensive whereas EPSObject is free (see below, however).
  82. !Artworks does not always convert text objects correctly. If you have AW
  83. then this can be demonstrated with the included demo file 'Elements' from
  84. CorelDraw 3.
  85.  
  86. Don't forget though, that Artworks is more than just an EPS file converter
  87. and is an excellent program in its' own right !!
  88. ---
  89.  
  90. Text/Font Translation
  91. =====================
  92.  
  93. Many (if not all) AI EPS files assume that the 32 standard Adobe Postscript fonts
  94. are present in the destination object (usually a printer). Therefore, in the
  95. EPS file, these fonts are referred to by name only and it's left to the 'receiver'
  96. to sort out the positional and size details using its' indigenous fonts. In the 
  97. case of the Archimedes, these fonts must be 'pointed' to the pre-installed outline
  98. fonts and '!EPSobject' will then use those instead. For this purpose a 'Font_Trans'
  99. table is required and must ultimately be ammended to direct the required fonts to
  100. those installed on your Archimedes. 
  101.  
  102. To achieve this, open the '!EPSobject' application (use <SHIFT>-select) and
  103. load the 'Font_Trans' file into a suitable Editor. The names in the lefthand column
  104. are as found in the EPS files and shouldn't be changed except to add new ones. The
  105. righthand column shows the Archimedes font assigned to the adjacent EPS font and this
  106. may/should be changed to suit your own particular system. If you do not have an
  107. equivalent for a particular entry in the lefthand column, then you should assign
  108. another font which *IS* available and this will be used instead.
  109.  
  110. Other, more exotic fonts are generally fully described in the EPS file and
  111. '!EPSobject' can usually convert these into drawpath objects from the supplied
  112. vector data. If however, you have the appropriate outline font available, and loaded
  113. in your system, then you can use this after suitably ammending the 'Font_Trans' table.
  114.  
  115. Any text in the EPS file, using fonts referred to by name only and not found in
  116. 'Font_Trans', *will* appear in the Draw file but using the default system font.
  117.  
  118. PLEASE NOTE that in the 'File_Trans' table the concluding 'END' statement must
  119. immediately follow the last data pair with NO spaces or empty characters between
  120. (exactly as shown).
  121.  
  122. ---
  123.  
  124. Using !EPSobject
  125. ================
  126.  
  127. Before starting you should set the filetype of the EPS files to &808 or &FF5.
  128.  
  129. To use just double-click on the '!EPSObject' Icon which installs the program
  130. on the Icon Bar. Dragging an EPS file to the Icon will open a 'save as' window
  131. (giving you the opportunity to enter an alternative name for the Draw object) 
  132. which can then be dragged to a suitable destination directory.
  133.  
  134. Processing will start immediately, indicated by the displayed Hourglass, and
  135. on completion the final converted Draw file will be stored in the chosen
  136. directory.
  137.  
  138. Batch processing is achieved by dragging a source directory containing
  139. suitable EPS files onto the Icon-Bar Icon and subsequently dragging the 'save'
  140. icon to some other suitable directory. All files <with filetype &808 or &FF5>
  141. within the source directory will be converted and stored with the same names.
  142.  
  143. --- 
  144.  
  145. Limitations
  146. ===========
  147.  
  148. The program as it stands still has many limitations.
  149.  
  150. For instance matrix patterns are as yet not supported and are consequently
  151. ignored. Fonts which are rotated or otherwise manipulated are not guaranteed to
  152. be translated correctly. Sometimes the font may appear in the correct format but
  153. still be in the wrong place. It's then up to you to manipulate them into the
  154. correct position using the !Draw application.
  155. The program is also rather limited as far as user friendliness is concerned and,
  156. as yet, doesn't multitask. These, and other problems, will be addressed in future
  157. versions (hopefully).
  158.  
  159. If you receive error messages then first read the 'ErrorMsgs' file. In general, if
  160. you discover any (God forbid!) spurious errors then please report these to the author
  161. (WL) giving details and preferably with a copy of the offending EPS file.
  162.  
  163. This program is an on-going project and newer versions will appear at irregular
  164. intervals. If there is sufficient interest then a 'Draw->EPS' convertor may
  165. also be considered.
  166.  
  167. EPS files of bit-image graphics are NOT supported, nor ever likely to be!!
  168.  
  169. ---
  170. ****************************************************************************
  171.  
  172. Construction of a typical AI EPS-File:
  173. ======================================
  174.  
  175. %!PS-Adobe-2.0 EPSF-2.0
  176. %%BoundingBox: 10 10 700 600                ---------------->used by EPSobject !
  177. %%Creator: WHOEVER-YOU-WANNA-BE
  178. %%Title: xxxxxx.eps
  179. %%CreationDate: Thu Sep 13 15:13:41 1678
  180. %%DocumentFonts: AvantGarde-Demi            ---------------->used by EPSobject !
  181. %%+AvantGarde-DemiOblique                   ---------------->used by EPSobject !
  182. %%+AvantGarde-Book                          ---------------->used by EPSobject !
  183. %%EndComments
  184.  
  185.  
  186. %%BeginProlog
  187. % -------------- POSTSCRIPT PROLOG FOR BBBBBBBBBB X.X ------
  188. % Copyright XXXXX Systems Corporation 1990
  189. /procname xyz def
  190. /    etc.
  191. /    etc.
  192. %%EndProlog
  193.  
  194. %%BeginSetup
  195. /varname 1234 def
  196. /    etc.
  197. %%EndSetup                  -------------------->   I M P O R T A N T   ! ! !
  198.  
  199. | HERE IS THE DATA FOR CONVERSION
  200. | HERE IS THE DATA FOR CONVERSION
  201. | HERE IS THE DATA FOR CONVERSION
  202. | HERE IS THE DATA FOR CONVERSION
  203. | HERE IS THE DATA FOR CONVERSION
  204. | HERE IS THE DATA FOR CONVERSION
  205. | HERE IS THE DATA FOR CONVERSION
  206. | HERE IS THE DATA FOR CONVERSION
  207.  
  208. %%Trailer -----> I M P O R T A N T  when appended information (eg. TIFF-image) follows!!!
  209.  end
  210. %%EOF
  211.  
  212. ---
  213.  
  214. Obligatory Conditions for Use and Distribution.
  215. ==============================================
  216.  
  217. This application is Freeware and as such may be freely copied and
  218. distributed with the following limitations.
  219.  
  220. a) The program (or any parts thereof) is not for commercial distribution.
  221. ie it is NOT to be sold for the purposes of profit. PD suppliers may not
  222. sell this program at a price in excess of the cost of postage/disc etc.
  223. ie <~ú1.00
  224.  
  225. b) All files (including this one) must be included in any distributed
  226. copies (see also d).
  227.  
  228. c) Any changes/improvements made by you (the user) should be reported to
  229. the author (WL) preferably with the ammended file(s). Significant improvements
  230. could then be collated and included in the next version for the benefit of
  231. everyone.
  232.  
  233. d) This program is copyright the Author(s) and is not to be distributed in
  234. an ammended or changed form.
  235.  
  236. e) The authors are not responsible for any damage incurred by use of this
  237. program.
  238.  
  239. f) All commercial products mentioned in this document are ⌐The manufacturers.
  240.  
  241. =========================================================================
  242.  
  243. Willi is too nice a guy to ask for any donation so I'll do it instead.
  244.  
  245. Despite being Freeware, I wouldn't object if you sent a moderate amount
  246. of money (say 5-10 pounds Sterling) to the Author (WH) in which case you
  247. will be registered and would receive immediate updates if and when they are
  248. issued. It would also give some incentive for developing '!EPSObject' further.
  249.  
  250. His address is:
  251.   
  252.   Willi Langhans
  253.   Tulpenweg 3a
  254.   W-3180 Wolfsburg 25
  255.   Germany
  256.   
  257. Alternatively you can contact him via me at:
  258.   
  259. Email: currell@mpi-muelheim.mpg.dbp.de
  260.  
  261.   Tel: +49 208 3043593 (daytime)
  262.        +49 208 33693   (evenings)
  263.  
  264. - L.J. Currell
  265.  
  266.